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Using this Addendum 

This addendum replaces chapters 1 through 4 of the HP CDE Getting Started 
Guide. 

This addendum contains information for: 

■ Preloaded HP-UX 10.30 systems (Instant Ignition). 

■ Systems updated from HP-UX 10.* to HP-UX 10.30. 

■ Systems upgraded from HP-UX 9.* to HP-UX 10.30. 

The other chapters of the HP CDE Getting Started Guide are still applicable 
for CDE running on HP-UX 10.30 systems. In those chapters, disregard 
specihc references to HP-UX 10.01 or HP-UX 10.10. 
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Introduction to HP CDE 


Note This chapter replaces chapter 1 of the HP CDE Getting Started 

Guide. 


CDE stands for “Common Desktop Environment,” and is an environment for 
interacting with your workstation. When CDE is running on your system, it is 
said to be your system’s “desktop.” 

CDE was designed to run on many hardware platforms sold by numerous 
UNIX workstation manufacturers. Thus, it is considered a “standard” desktop. 

HP CDE is HP’s version of CDE. It includes: 

■ All the functionality of the standard CDE product (called the CDE standard 
implementation or standard CDE). 

■ Enhancements added by HP. 


Where to Get Information on Using CDE 

starting CDE on a Preloaded System 

If your workstation is a CDE preloaded (Instant Ignition) system, it has 
been conhgured to automatically run CDE. However, there is some initial 
system setup you must perform. See “Starting a Preloaded CDE System” in 
Chapter 2. 
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HP-Specific Information about CDE 

That’s what this manual covers, including: 

■ How to install and start CDE. 

■ HP enhancements to CDE. 

■ How to migrate customizations made to HP VUE into CDE. 

Standard CDE Users Information 

The standard CDE desktop is described in: 

■ The online help for the CDE applications—for example, Eile Manager Help 
and Style Manager Help. 

■ The Common Desktop Environment User’s Guide. 

Standard CDE System Administration Documentation 

System administration for CDE is covered in the Common Desktop 
Environment Advanced User’s and System Administrator’s Guide. 

Application Administration Online Help 

To display a help volume covering many system administration tasks involved 
with adding and administering applications: 

1. Open the Help Manager by clicking the Help Manager control in the Eront 
Panel. 

2. Click the hyperlink Common Desktop Environment. 

3. Click the hyperlink Administering Desktop Applications. 
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HP Enhancements to CDE 

HP’s enhancements to CDE include: 

■ A suite of multimedia applications called MPower//Web. See “The 
MPower//Web Applications” in Chapter 3. 

■ The hpterm terminal emulator. 

■ Several system administration enhancements that optimize CDE on HP 
systems. 

■ Tools for migrating from the HP VUE desktop to CDE. 

□ VUEtoCDE. Users can run VUEtoCDE to migrate personal customizations 
such as the Personal Toolbox and Eront Panel. System administrators 

can run VUEtoCDE to migrate system-wide changes such as the General 
Toolbox and system-wide key and button bindings. 

□ An uninstall script for HP VUE. 
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Starting CDE 


Note This chapter replaces chapters 2 and 3 of the HP CDE Getting 

Started Guide. 


This chapter covers how to start CDE on: 

■ A preloaded (Instant Ignition) HP-UX 10.30/CDE system. 

■ A system updated or upgraded to HP-UX 10.30. 

■ A new, non-preloaded system with HP-UX 10.30 media. 


Starting a Preloaded CDE System 

If you have not yet installed your workstation, see the Hardware Installation 
Guide. 

Once your workstation is installed, follow the instructions in this chapter for 
starting it for the hrst time. 

Getting Required Information 

The start-up procedure for your workstation will require you to supply the 
following information. Therefore, you should hud out this information before 
you turn the workstation on for the hrst time. 


Note If you do not have some of this information, you can add that 

information later. You should add the information as soon as 
possible. 
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■ hostname _ 

The hostname is sometimes called the “system name.” 

■ Internet Protocol address _ 

You will need this address if you are connecting the workstation to a local 
area network. 

■ time zone _ 

This is the time zone where the workstation is located. 

■ Optional networking parameters. 

Ask your system administrator if you need to conhgure these parameters. 

Subnetwork mask _ 

Network gateway IP address _ 

Local domain name _ 

DNS server host name _ 

DNS server IP address _ 

Network Information Service _ 

domain name 

■ Optional font server parameters. 

You need to supply these parameters if you want the workstation to obtain 
its fonts on a network server. Ask your system administrator if you need to 
conhgure these parameters. 

Font server name _ 

Font server IP address _ 

Turning on the Power 

1. Turn on the monitor and any external peripherals (for example, printers) 
connected to the workstation. 

2. Turn on the workstation. 
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The workstation will run a series of self-tests. For information about these 
self-tests, see the troubleshooting chapter of the Owner’s Guide. 

3. After two or three minutes, a series of messages is displayed as various 
hardware and software subsystems are activated. 

Unless something is wrong with your system, you are not asked to respond 
to these messages. 

4. A series of windows appears requesting the information you gathered in the 
previous section, such as your hostname, IP address, and time zone. Enter 
the information as it is requested. 


Note You should enter the hostname when requested; otherwise, you 

will get an error message when you log in. 

If you do not have other pieces of information, press [Return ] 
or [Enter ") to use the default value. You can provide missing 
information later by logging into a terminal emulator window 
as superuser and executing the command: 

/sbin/set_parms 


5. You are now asked if you want to set a root password. Specify the root 
password now. 

The root password is the password used for the superuser account. The 
superuser is a special user who has permission to perform all system 
administration tasks. The user name for the superuser is root. 

6. When you have hnished answering all the questions, the workstation 
completes its startup sequence and displays the CDE login screen. 

7. Log into your hrst CDE session as root. For information on logging into 
CDE, see the Common Desktop Environment User’s Guide. 


Note You must log into the hrst session as root. This is because the 

system contains no other user accounts. Once you have created 
user accounts, you should log out as superuser and log back in 
as one of the other users. 


8. Use SAM to set up user accounts. 
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To Set User Accounts 

1. Open the System_Admin application group in the Application Manager and 
double-click SAM. 

This starts SAM—the System Administration Manager. 

2. In the SAM main window, double-click Users and Groups. This opens the 
Users and Groups window. 

3. Double-click Users. This opens the Users window. 

4. Choose Add from the Actions menu. This opens the Add a User Account 
window. 

5. Fill in the text helds: 

a. In the Login Name text held, type the user name for the new account. 

b. Use the SAM online help for instructions on hlling out the other helds. 

6. Click OK. This opens the password window. Type a password and click OK. 
At the request to re-enter the password, type it again and click OK. 

7. Then the Task Completed message appears, click OK. 

Repeat this procedure for each user account. 


Installing and Running CDE on a New, Non-Preloaded 
System 

Installation of HP-UX 10.30 automatically: 

■ Installs CDE. 

■ Conhgures the workstation to run CDE automatically each time the system 
is rebooted. 


2-4 Starting CDE 


FINAL TRIM SIZE : 7.5 in x 9.0 in 



starting CDE on an Updated or Upgraded Workstation 

This section describes how to install and conhgure CDE on: 

■ Existing 10.* systems being updated to HP-UX 10.30. 

■ Existing 9.* systems being upgraded to HP-UX 10.30. 

Installing and Running CDE on Updated Systems 

When a system is updated from previous 10.* releases to HP-UX 10.30, and 
the “Match What Target Has” install option is chosen, then: 

■ CDE is automatically installed onto the system. 

■ The system is conhgured to automatically run CDE. 

This applies both to systems that contain previous versions of CDE, and those 
that do not. Refer to the installation instructions accompanying the media 
(tape or CD) for additional update instructions. 

Systems that previously ran CDE 

If the system already has CDE installed, then the hies in /usr/dt are replaced 
with the newest version of those hies. This has no effect on system-wide or 
personal customizations. 

Systems that previously ran HP VUE 

Since HP VUE is obsolete with HP-UX 10.30, “Match What Target Has” 
automatically provides CDE as the replacement desktop and installs CDE hies. 

Installation of HP-UX 10.30 does not: 

m Remove HP VUE hies. 

■ Convert any system-wide or personal HP VUE customizations to the CDE 
desktop. 

HP-UX 10.30 provides an application, VUEtoCDE, that migrates most HP 
VUE customizations to CDE. 
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Installing and Running CDE on Upgraded Systems 

The upgrade from HP-UX 9.* to HP-UX 10.30 is a two-step procedure: 

1. The system is upgraded from HP-UX 9.* to HP-UX 10.01 or HP-UX 10.10. 
During this upgrade, HP VUE conhguration hies are moved to new locations 
consistent with the HP-UX 10.* hie organization. For example, system-wide 
customizations in /usr/vue/conf ig are moved to the new location for 
system-wide customizations—/etc/vue/conf ig. 

2. The system is updated to HP-UX 10.30. During this update, CDE is 
automatically installed. See “Installing and Running CDE on Updated 
Systems”. 


Removing HP VUE and HP MPower 

HP VUE and HP MPower are not supported on HP-UX 10.30 or later releases. 


Note HP MPower is not the same product as HP MPower//Web. 

The MPower//Web product is supported on HP-UX 10.30. 


It is recommended that you remove the HP VUE and HP MPower 
factory-installed hlesets from your system to recover the disk space they 
occupy. 


Note Removing the factory-installed hlesets will not remove 

system-wide and personal HP VUE customizations, assuming 
those customizations were not made in locations reserved for 
built-in conhguration hies. If you are uncertain about the 
locations of your customizations and you want to preserve them 
in CDE, you should delay removal of HP VUE until you’ve run 
the VUEtoCDE migration tool. 


To remove HP VUE and/or HP MPower: 

1. Double-click “Uninstall HP VUE” in the System_Admin application group 
in the Application Manager. 
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2. Follow the instructions in the displayed dialog boxes. 
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Additional Desktop Applications and 
Enhancements 


Note This chapter replaces chapter 4 of the HP CDE Getting Started 

Guide. 


This chapter covers additions to CDE provided by HP, including: 

■ The MPower//Web set of applications. 

■ The hpterm terminal emulator, hpterm is a TermO-compatible terminal 
emulator. 

■ System administration enhancements. 


The MPower//Web Applications 


Note MPower//Web is provided on preloaded 10.30 systems. For 

non-preloaded systems, MPower//Web can be installed from 
the HP-UX Applications Release 10.30 media. 


MPower//Web is a collection of multimedia and collaboration applications that 
run in the CDE environment. 

The MPower//Web applications provide: 

■ A World Wide Web browser. 

■ Multimedia applications: 2D and 3D image viewing, image printing, audio 
recording and playback, and video playback. 

■ Collaboration tools: SharedX and Whiteboard. 
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When MPower//Web is installed on a system, its online help is displayed 
automatically in a Netscape Navigator window the hrst time you log in. 


hpterm Terminal Emulator 

This section describes how to: 

■ Run hpterm. 

■ Make hpterm the default terminal emulator. 

■ Modify the Terminal control in the Front Panel to run hpterm. 

To Run hpterm 

1. Open the Desktop_Tools application group in the Application Manager. 

2. Double-click Hpterm. 

To Make hpterm the Default Terminal Emulator 

The following procedure changes the terminal emulator run by the desktop 
when a terminal is started—for example, when you choose Open Terminal from 
File Manager’s File menu. 

1. Copy the hie /usr/dt/appconf ig/types//ang(Mag(e/user-pref s . dt to one 
of the following directories: 

■ Personal customization: HomeDirectory/ .dt/types 

■ System-wide customization: /etc/dt/appconfig/types//ang(Mag(e 

2. Edit the MAP_ACTION held of the Terminal action dehnition to re-map it 
to the Hpterm action: 

ACTIOI Terminal 

{ 

MAP.ACTIOI Hpterm 

> 
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3. Double-click Reload Actions in the Desktop_Tools application group. 


To Modify the Terminal Front Panel Control to Run hpterm 

1. Locate the dehnition for the Term control in the hie 

/usr/ dt/appconf ig/types / language /dtma. f p. 

COITROL Term 

{ 

TYPE icon 

COITAIIER.MME PersAppsSubpanel 

COITAIIER.TYPE SUBPAIEL 


> 

2. Copy the entire Term control dehnition to a new hie: 

■ Personal customization: HomeDirectory / .dt/types/terminal .fp. 

■ System-wide customization: 

/etc/dt/appconf ig/types /language /terminal .fp 

3. Edit the PUSH_ACTION held: 

PUSH.ACTIOI Hpterm 


4. Choose Restart Workspace Manager from the Workspace Menu. 


System Administration Enhancements to CDE 

This section covers enhancements made to CDE to optimize system 
administration on HP systems: 

■ Additions to the CDE Help Search Path. 

■ Setting search paths during remote execution. 

■ Setting the mount point for remote hies. 
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Additions to the Default Help Search Path 

The CDE help viewer can register and display help volumes created using the 
HP (VUE) Help System. A help volume must be registered in order for it to: 

■ Appear in the Help Browser. 

■ Have entries in the Help Index. 

CDE uses a help search path to locate and register help volumes. 

The following locations and their subdirectories have been added to the default 
CDE help search path. 

/etc/vhelp 

/usr/vhelp 

Systems upgraded to CDE from HP VUE generally have their existing help 
volumes registered into /etc/vhelp/volumes/^TAVGr. 


Note HP VUE and CDE have different sets of help volumes. Eor 

example, the CDE and HP VUE Eile Managers each have their 
own help volume. 

If a system contains CDE and HP VUE, help volumes for 
both desktops are present. Applications will access the correct 
help volume. However, when All Volumes is selected in the 
Help-Index Search window, both CDE and HP VUE help 
volumes are listed. 


Setting Search Paths During Remote Execution 

CDE uses environment variables to specify search paths for application groups, 
icons, help hies, and action/data-type hies. These search paths are set during 
login. 

If you use actions to run remote processes, you may experience unexpected 
behavior if the environment on the remote system differs from the local 
environment. Eor example, suppose a session server named SystemA 
contains the customized icon /etc/dt/appconfig/icons/C/CUST.pm. 

Since the directory /etc/dt/appconfig/icons/C is on SystemA’s icon 
search path, local applications can hud the icon. However, when SystemA 
invokes an application on SystemB that needs the icon, the icon will not be 
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found. This is because SystemB will inherit the icon search path element 
/etc/dt/appconf ig/icons/C, but this directory on SystemB does not contain 
the icon. 

CDE provides a way to properly map search paths in the network. By 
default, this is turned off for HP-UX systems, since it can cause a decrease in 
performance during remote execution. 

There are two ways to ensure that search paths will be properly propagated to 
remote systems: 

■ You can conhgure the network so that the CDE directories appear identical 
from every system in the network. The easiest way to accomplish this is to 
NES-mount the same disk containing the CDE environment from each node. 

■ You can conhgure the system to do search path mapping by setting the 

*dtEnvMapForRemote resource. 

Using dtEnvMapForRemote 

The syntax for the dtEnvMapForRemote resource is: 

♦dtEnvMapForRemote variable\^: variable] . .. 

where variable is the name of an environment variable whose value is to be 
mapped. 

Eor example: 

♦dtEnvMapForRemote XMICOISEARCHPATH:DTHELPSEARCHPATH:DTDATABASESEARCHPATH 

specihes that the CDE icon, help, and actions/data-types search paths should 
be mapped. 

In the case of the missing Gust .pm pixmap, you would set the following 
resource on SystemB: 

♦dtEnvMapForRemote XMICOISEARCHPATH 

This changes the path inherited from SystemA, /etc/dt/appconfig/icons/C, 
to /net/SystemA/etc/dt/appconf ig/icons/C. The icon will then be found if 
the SystemA directory is mounted on SystemB. 


Additional Desktop Applications and Enhancements 3-5 


FINAL TRIM SIZE : 7.5 in x 9.0 in 



Setting the Mount Point for Remote Files 

To provide “network transparency” for files, CDE does automatic file name 
mapping. This mapping converts file paths to appropriate network paths. 

When explicit mounting is done in /etc/checklist, CDE uses those 
mount points in its mapping. However, when an automounter is used, CDE 
assumes the mount point to be /net. If a different mount point is used, the 
DTMOUNTPOINT environment variable must be set. 

Chapter 5 of the CDE Advanced User’s and System Administrator’s Guide 
describes how to set DTMOUNTPOINT. One step in this task involves 
modifying /etc/inetd.sec. 

Eor HP-UX systems, the rpc.ttdbserver entry in /etc/inetd.conf should 
be: 


rpc stream tcp 
rather than: 

rpc stream tcp 


swait 


wait 
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